Skip to content

Introduction

The workshop is/was from 10:00 to 13:00 (UTC+2) on 19 April 2026. Online participants can join through the meeting link (sent separately).

The workshop presentation (what you are looking at now) is part of the echoSMs documentation, available at:

https://ices-tools-dev.github.io/echoSMs/training/2026 WGFAST workshop/overview/

The workshop files and notebooks are automatically on your online computer (and also in a github repository here).

The aims of this workshop are for you to:

  • Provide shapes to the datastore,
  • Obtain shapes from the datastore,
  • Run echoSMs scattering models,
  • Help you choose appropriate scattering models
  • Provide feedback on the models and datastore
Ask questions, provide feedback, etc, at any time

Or talk to or email us later (Gavin, Mike).

Shape datastore

The echoSMs project is developing an online datastore for scattering model shapes and associated metadata. The aim is to facilitate long-term access to good quality scattering model input data, especially the shapes.

Three echoSMs datastore hackathons have been held (21 Jan, 28 Jan, and 24 March 2026) with interested users. The datastore design has benefited considerably from these hackathons and what you'll see today is a near-final version.

Scattering models
We'll use the echoSMs scattering model Python package (has nine models relevant to fish and plankton acoustics).
Selecting scattering models
A common request from the echoSMs workshop at the 2025 WGFAST meeting was for guidance on selecting appropriate acoustics scattering models. We have added a short section on that to today's workshop.

Virtual workshop computer

To reduce setup time we provide individual online Linux computers with pre-configured software and resources. You are welcome to work on your local computer if you want to but we won't have much time to help with configuration problems (the workshop files are available here).

Access to your online computer is entirely via your web browser:

  1. Click this link to start your server and download/update the workshop files to your online computer.
  2. Sign in with an email address (any unique email address will work)
  3. The password will be given during the workshop
  4. Choose the Py-R - echoSMs hackathon - latest image
  5. The default resource allocation is fine
  6. Click on Start
  7. You'll end up in a JupyterHub instance in your web browser - it can take a few minutes to get there
  8. Right click on the file that the link opened and choose Show Markdown Preview
  9. Open a Terminal (click on the new tab icon: +) and type these lines:
    1. pip install echosms --upgrade
    2. pip install jmespath

JupyterHub notebooks are in the notebooks directory on your online computer and data files are in the shapes directory.